home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 4 / CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso / magazine / psion / games / hr112.lzx / homerun.txt < prev    next >
Text File  |  2001-05-20  |  17KB  |  390 lines
  1.                 HomeRun Version 1.12 10th February, 1994
  2.               - A Card Solitaire for the Psion Series 3a -
  3.  
  4.              Copyright 1993, 1994 Right Hand Software Ltd.
  5.  
  6.               45, Kenilworth Gardens, London SE18 3JB, UK
  7.                         Phone/Fax : 081-319-8576
  8.  
  9.                                - Email -
  10.                      righthand@cix.compulink.co.uk
  11.                      chennings@cix.compulink.co.uk
  12.                        100010,511@compuserve.com
  13.  
  14.  
  15. 1)  Introduction
  16.  
  17.     HomeRun is a traditional card solitaire for the Psion Series 3a. The
  18.     game can also be played in by 2 players in competition mode. Game
  19.     play, rules and scoring are described below.  HomeRun offers a full
  20.     graphical display of the pack of cards, animation, digital sounds,
  21.     highscore tables and player statistics.  Have Fun!
  22.  
  23. 2)  Shareware
  24.  
  25.     HomeRun is shareware which means you are granted a limited license
  26.     to evaluate the program.  If after a fair and reasonable period of
  27.     evaluation (no more than 14 days should be considered reasonable),
  28.     you wish to continue to use the program you must register it.
  29.  
  30.     Registration is important.  It means that you are actively
  31.     supporting the development of low cost, high quality software for
  32.     the Psion range of computers.
  33.  
  34.     In recognition of this, registered users receive an access code
  35.     which will :
  36.  
  37.     a) Enable the facilities for saving game setup and options,
  38.        highscores and player statistics to disk.
  39.  
  40.     b) Enable the "Undo Last Move" function.
  41.  
  42.     c) Remove the "reminder" dialogs.
  43.  
  44.     You can register your copy of HomeRun with a payment of a minimum of
  45.     10.00 ukp or $15.00 (US) or local equivalent.  Payment should be by
  46.     cheques drawn on UK Banks or Building Societies made payable to
  47.     Right Hand Software Ltd, in cash or via the Compuserve shareware
  48.     registration service (Go SWREG). Please contact us if you wish to
  49.     discuss other forms of payment.
  50.  
  51.     Please read the full Terms & Conditions of use that are set out in
  52.     the following section.
  53.  
  54. 3)  Terms & Conditions
  55.  
  56.     a) HomeRun comprises the files HOMERUN.APP, HR1.WVE, HR2.WVE,
  57.        HR3.WVE, HR4.WVE, HR5.WVE, HR6.WVE, RHS.WVE and this file
  58.        HOMERUN.TXT. HomeRun is copyright material of Right Hand Software
  59.        Ltd. and all ownership rights are retained.
  60.  
  61.     b) You may use and distribute HomeRun only in accordance with the
  62.        terms and conditions stated here.
  63.  
  64.     c) You may NOT modify HomeRun in any way.
  65.  
  66.     d) You may use HomeRun free of charge ONLY for a fair and reasonable
  67.        period of time (14 days) in order to evaluate the program. For
  68.        all and any subsequent use of the program, you must register your
  69.        copy as described in section (2) above.
  70.  
  71.        You may use HomeRun only in a personal and private capacity. Use
  72.        within commercial, corporate or government institutions requires
  73.        a commercial users licence.
  74.  
  75.     e) You may distribute HomeRun only provided that :
  76.  
  77.        i)   All the original files are included (in particular these
  78.             terms and conditions).
  79.  
  80.        ii)  NO charge is made other than to cover the fair and
  81.             reasonable costs of distribution.
  82.  
  83.        Any distribution of HomeRun that renders any form of commercial
  84.        advantage (financial or otherwise) to the distributor, requires a
  85.        commercial distributors license.
  86.  
  87.     f) While appropriate care has been taken in the creation of HomeRun,
  88.        Right Hand Software Ltd. does not warrant that the software is
  89.        error free.  Indeed, Right Hand Software Ltd. disclaims all and
  90.        any warranties relating to the software.
  91.  
  92.     g) Under no circumstances shall Right Hand Software Ltd. be liable
  93.        for consequential, incidental or indirect damages of any kind
  94.        arising from the use of the HomeRun software.
  95.  
  96. 4)  Installation & Logistics
  97.  
  98.     a) Setup
  99.  
  100.        Copy the file HOMERUN.APP to any directory on any drive and use
  101.        PSION-I to install HomeRun to the system screen. Alternatively,
  102.        place HomeRun in an \IMG\ directory so that it can be launched
  103.        from the RUNIMG filelist.
  104.  
  105.        HomeRun is a type 0 application and so has no filelist on the
  106.        system screen.
  107.  
  108.        HomeRun uses various .WVE files to provide digital sound. These
  109.        files should be copied to a \HOMERUN\ directory located below
  110.        where the main .APP resides. Alternatively the .WVE files can be
  111.        copied to a \WVE\ directory on any drive.  If you don't
  112.        want HomeRun use digital sound, simply rename or delete the .WVE
  113.        files.  HomeRun will then use simple tones to provide sound
  114.        effects.  Sound effects can be fully disabled using the Game
  115.        Options dialog.
  116.  
  117.     b) Files
  118.  
  119.        HomeRun uses 2 types of file.  Firstly, HomeRun is resource based
  120.        (English language resources are embedded in the main .app) and
  121.        HomeRun will look for foreign language resource files in a
  122.        \HOMERUN\ (or whatever you rename HOMERUN.APP to) directory that
  123.        must be located under the directory from which the app is
  124.        launched.  No foreign language resource files currently exist but
  125.        if anyone is interested in doing the translation work, we will be
  126.        happy to supply them.
  127.  
  128.        Secondly, for registered users, HomeRun will save various setting
  129.        to the file HOMERUN.INI. HomeRun will attempt to create the .INI
  130.        file in a \HMR\ directory in the root of the default drive.  If
  131.        the default drive is a RAM drive this will be transparent to the
  132.        user.  However, if the default drive is not a RAM drive, you will
  133.        be prompted to select an appropriate drive.  You can select a
  134.        FLASH drive to contain the .INI file but this is not recommended
  135.        as the .INI file is written to quite frequently.  Once a .INI
  136.        file has been established on any writable RAM (or FLASH) drive, it
  137.        will be auotmatically detected and no further prompting will
  138.        occur.
  139.  
  140.     c) General Operation.
  141.  
  142.        To launch HomeRun, make sure that the .APP has been installed as
  143.        described above and that it is showing on the System screen.
  144.        Select HomeRun and press enter.
  145.  
  146.        HomeRun has supports online help.  Press the HELP key for details
  147.        of how to use the various facilities available.
  148.  
  149.        A summary of the active keys is shown below :
  150.  
  151.        Cursors : The Left, Right, Home and End cursor keys are used to
  152.                  select a card to play.  The Up and Down cursors will
  153.                  automatically "find" playable cards.
  154.  
  155.        Space   : The Space key plays a card.
  156.  
  157.        Enter   : The Enter key is equivalent to pressing the Home key
  158.                  followed by the Space key and has the effect of playing
  159.                  a new card from the pack.
  160.  
  161.        Menu    : Brings up the menu bar.
  162.  
  163.        Help    : Brings up the help system.
  164.  
  165.        Psion-N : Starts a new game.
  166.  
  167.        Psion-S : This presents a dialog from which you can Setup the
  168.                  type of game to play - the number of players and who
  169.                  they are and for a 2 player game the number of hands
  170.                  over which the competition is to run.
  171.  
  172.        Psion-O : This presents a dialog from which you can control the
  173.                  game Options regarding animation and sound effects.
  174.                  Note: if card animation is turned on, the initial the
  175.                  pack dealing routine will always go at the maximum
  176.                  speed.
  177.  
  178.        Psion-H : Displays the highscore table.
  179.  
  180.        Psion-C : Deletes the current highscore table (to give others
  181.                  less skilled than yourself a chance to get their name
  182.                  in lights).
  183.  
  184.        Psion-P : Displays various statistics relating to the current
  185.                  players.
  186.  
  187.        Psion-R : Use this to register your copy of HomeRun.
  188.  
  189.        Psion-U : For registered users only, this will undo the last move
  190.                  except when that move resulted in an end game.
  191.  
  192.        Psion-A : Displays copyright and program version information.
  193.  
  194.        Psion-X : Exits the program.
  195.  
  196. 5)  HomeRun - The Game
  197.  
  198.     On startup, the program information screen is displayed and once
  199.     cleared, the game begins.
  200.  
  201.     HomeRun is played with a standard pack of 52 playing cards PLUS up
  202.     to 4 Jokers.  At the start of a game you have all 4 Jokers.
  203.  
  204.     The game starts with 35 cards being dealt into 7 ranks of 5 cards. A
  205.     single card is then dealt and placed in the bottom left hand corner.
  206.     The remaining cards are placed face down in the top left hand
  207.     corner.
  208.  
  209.     The basic game play involves taking cards from the front of any of
  210.     the ranks and placing them on the layout card in the bottom left
  211.     hand corner.  However you can only do this if the face value of the
  212.     card is 1 greater than or 1 less than that of the layout card - so
  213.     you are looking to make runs of cards such as 3 4 5 or K Q J 10 or
  214.     even 4 5 4 5 4 5.  Aces are low. Jokers can have any value so any
  215.     card can be placed on them and they can go on any card - so they are
  216.     very useful!
  217.  
  218.     If it is not possible to move any of the cards from the 7 ranks you
  219.     can play a new layout card from the pack in the top left hand
  220.     corner.
  221.  
  222.     The objective of the game is simply to clear all the 35 cards in 7
  223.     ranks while gaining as many points and bonuses as possible.
  224.  
  225.     If you do clear all 35 cards, the pack is redealt and your turn
  226.     continues.  However, 1 Joker is removed, making it harder to clear
  227.     the next set of cards.
  228.  
  229. 6)  Scoring and Bonus Points
  230.  
  231.     For each card you play from the 7 ranks, points are awarded
  232.     according to its face value. The values are :
  233.  
  234.                     King, Ace          = 12 points
  235.                     Queen, 2           = 10 points
  236.                     Jack, 3            =  8 points
  237.                     10, 4              =  6 points
  238.                     9, 5               =  4 points
  239.                     8, 7, 6            =  2 points
  240.                     Joker              =  0 points
  241.  
  242.     Additionally, if you manage to make a pure run of 4 or more cards,
  243.     you get 10 bonus points for each card in the run after the 3rd card.
  244.     A pure run is an ascending or descending "straight" ie 3, 4, 5, 6 or
  245.     Q, J, 10, 9.  Sequences such as 4, 5, 4, 5 are not eligable for
  246.     bonus points but are obviously important for clearing all 35 cards
  247.     and completing the hand.  In some situations you will need to make a
  248.     judgement as to whether to go for bonus points or for a sequence
  249.     that has a better chance of getting to the end of the hand.
  250.  
  251.     If you clear all 35 cards you are awarded various additional
  252.     bonuses.  You get 20 bonus points for completing the hand.  You get
  253.     10 points for each card remaining unused in the pack and you get 50
  254.     points for any unused Jokers.
  255.  
  256.     You now enter the "Bonus Gamble" section.  A single card is dealt
  257.     and you are offer a chance to increase your bonus score by betting
  258.     as to whether the next card is higher or lower.  A dialog shows the
  259.     points on offer and you can choose to collect you current bonus or
  260.     go for the higher value by going high or low.
  261.  
  262.     If you bet and you're right you get the higher bonus and can bet
  263.     again.  If you're wrong that ALL your bonus points are lost.  If the
  264.     next card has the same value as the one showing, you collect your
  265.     current (lower) bonus.   If you draw evens or you lose and your
  266.     bonus is high enough, you get the opportunity to exchange the full
  267.     bonus for a Joker.
  268.  
  269.     Once you have more than 300 bonus points, winning the gamble gains
  270.     you an extra Joker for the next hand (ie the number of Jokers is
  271.     not reduced) - this is the best way to get really high scores as
  272.     fewer Jokers makes it a lot harder to clear the ranks.
  273.  
  274. 7)  The End Game
  275.  
  276.     If you have cleared all the ranks and the bonus gamble routine has
  277.     completed, your score plus bonuses are added to the players total
  278.     shown in the information window. If the if the score for the game is
  279.     good enough, its position in the highscore table is shown. If the
  280.     score is not a highscore but is still a personal best, the player
  281.     statistics dialog is displayed.  The pack is then redealt and the
  282.     players turn continues.
  283.  
  284.     If you cannot play a card, the game ends and any highscore or
  285.     personal best is notified.  If you are playing a single player game,
  286.     you will now need to do a Psion-N to start a new game.  If you are
  287.     playing a 2 player game, the cards are redealt automatically and
  288.     play passes to the next player.  Once player 2 has completed the
  289.     number of games in the competition (as defined in the Setup New Game
  290.     dialog), the competition is over and you will now need to do a
  291.     Psion-N to start a new competition.
  292.  
  293. 8)  The Information Window
  294.  
  295.     The Information window is located at the bottom of the screen and
  296.     shows then number of unplayed cards in the pack, the number of
  297.     unplayed Jokers, the current hand score and bonus for the current
  298.     player and the running total over several hands in a game and games
  299.     in a competition for the 2 players.  Note the diamond marker
  300.     indicates the current player.
  301.  
  302. 9)  That's all folks ... Have Fun!
  303.  
  304. === End of HomeRun v1.12 Documentation ===================================
  305.  
  306. VERSION HISTORY ...
  307.  
  308. === HomeRun v1.12 Changes from v1.11b ====================================
  309.  
  310. *  Minor Help text changes
  311.  
  312. === HomeRun v1.11b Changes from v1.10  ===================================
  313.  
  314. *  Changed confusing text in the "Swop Bonus for Joker" dialog.
  315.  
  316. *  "Swop Bonus for Joker" option now is random when you lose a gamble
  317.     with more than 240 bonus points.
  318.  
  319. *  Fixed error (trapped by "stray signal death" routine) arising when
  320.    sounds switched on but no .WVE files found.
  321.  
  322. === HomeRun v1.10b Changes from v1.00  ===================================
  323.  
  324. *  Added FindCard Routine - A number of people requested various
  325.    improvements to card navigation, this one turned out to be the most
  326.    powerful (it's almost cheating!).
  327.  
  328. *  Changed .INI file location to appropriately handle default drive
  329.    settings.
  330.  
  331. *  Added HELP key handling on Dialogs via a hLastSystemKey call.  Help
  332.    text amended and restructeded.
  333.  
  334. *  Changed spread of card scores.  Exchange Bonus for Joker option added
  335.    to bonus gamble (high bonuses only).  Joker jackpot now 300 points.
  336.  
  337. *  Conversion to asynchronous event handling.  DealCard routine
  338.    reimplmented within main event loop. This also fixes a rare case
  339.    where async sound playing could lead to an io semaphore imbalance.
  340.  
  341. *  Bug Fix : Undo, followed by attempt to play an invalid card, followed
  342.    by a further Undo severely confused v1.00.
  343.  
  344. *  Bug Fix : Setup player details in single player game using anything
  345.    other than player slot 1 was not handled correctly.
  346.  
  347. === HomeRun v1.00 Changes from v0.92b ====================================
  348.  
  349. *  Added further / finalised sounds.
  350.  
  351. *  .WVE files REALLY correctly handled in a APP\HOMERUN\ directory
  352.  
  353. *  Opted for blank background to cleared ranks
  354.  
  355. *  Game Options settings correctly saved to disk (for reg'd users)
  356.  
  357. *  "Press Esc or Enter" prompt shortened to "Press Enter"
  358.  
  359. === HomeRun v0.92b Changes from v0.91b ===================================
  360.  
  361. *  .SHD file amended to show HomeRun as the app name on the system
  362.    screen rather than "Runner" - the original working title.
  363.  
  364. *  .WVE files correctly handled in a APP\HOMERUN\ directory
  365.  
  366. *  Improved control options for sound/animation fx on dealing
  367.  
  368. *  Increased cursor blink rate for better visibility
  369.  
  370. *  Home/End keys now sensitive to empty ranks
  371.  
  372. *  Build card routine uses G_TRMODE_SET rather than G_TRMODE_REPL to
  373.    stop losing pixels in suit icons through overwriting on cards where
  374.    suit icons are densely packed eg 9s and 10s
  375.  
  376. *  New display for empty ranks instead of simple grey fill
  377.  
  378. *  Enter key is used instead of Shift+Space to play a pack card
  379.  
  380. *  Game now correctly recognises end game situation and does not process
  381.    cursor keys, Space or Enter - these were previously active and would
  382.    panic or muck up subsequent play if pressed once a game completed.
  383.  
  384. *  UNDO last move feature added (only for registered users) - I'm
  385.    actually very pleased with this 'cos I keep doing silly things.
  386.    There's no penalty for using this so I guess it'll be up to you to
  387.    declare it's use when you are boasting about highscores!
  388.  
  389. === End of Version History ==============================================
  390.